Entra ID OAuth2

To configure Entra ID OAuth2 for erwin Mart Portal authentication, follow these steps:

1. Log in to the Microsoft Entra admin center.

2. Click App registrations and enter the necessary information as shown in the following image.

   

3. Click Register.

4. Go to Certificates & secrets.

   

5. Click New client secret and add a Description. Then, click Add.

   

6. Copy the auto-generated value highlighted in the following image.

   

7. Click API permissions > Application permissions.

   

8. Search and expand Group and select Group.Read.All permission. Then, click Add permissions.

   

9. Search and expand User and select User.Read.All permission. Then, click Add permissions.

   

10. Click Grant admin consent for Contoso.

    

11. Go to Authentication and click Add a platform.

    

12. Click Web.

    

13. Add Redirect URIs and click Configure.

    

14. Go to Overview and note the Application (client) ID and Directory (tenant) ID. Graph scope and Client Uri are default.

    

15. Depending on your Mart version, do one of the following:

    • For Mart Portal on-premises, on the erwin Mart Portal Configuration screen, click the Authentication tab, and configure the following parameters for SSO, as shown in the example image.

      

    • For Mart Portal on cloud, share the following details with the Mart Cloud Support team:

      • Tenant ID

      • Graph Scope

      • Client ID

      • Client URI

      • Client Secret

      Once the support team authenticates erwin Mart Portal for you, you can move to adding groups in erwin Mart Portal at https://<your_instance>.myerwin.com/MartPortal.

Adding Users in erwin Mart Portal

To add your Entra ID users to erwin Mart Portal, follow these steps:

1. Log in to the erwin Mart Portal as an administrator.

2. Go to Application Menu > Users.
   The Users page appears.

   

3. Click Add User.
   The Add User page opens.

   

4. In the User Type field, select Entra ID User and add details in the Username, Display Name, Email Address, and Confirm Email Address fields.

5. Click Save.

The user has been added.

Adding Groups in erwin Mart Portal

To add your Entra ID groups to erwin Mart Portal, follow these steps:

1. In the Microsoft Entra admin center, click Groups > All groups > Download groups.
   

2. Log in to the erwin Mart Portal as an administrator.

3. Go to Application Menu > Users.
   The Users page opens.

   

4. Click Add User.
   The Add User page appears.

5. Under User Type, select Entra ID Group.

   

6. Under Group name, select the group that you want to add.

7. In the Email Address field, enter your email address.

8. Click Save.

The group has been added.